Skip to main content

DocuSign actions

1. About DocuSign Auth:

To retrieve access token and refresh token using Authorization Code Grant.

To use this connetctor you need to setup the app in your DocuSign account with the redirect URI as : {YOUR_RUNTIME_URL}/services/api/docusign/auth.

Before you can make any API calls using Authorization Code Grant, you must get your user’s consent for your app to act for them.To get this consent, open the accompanying example URI in your embedded browser https://account-d.docusign.com/oauth/auth?response_type=code&scope=YOUR_REQUESTED_SCOPES&client_id=YOUR_INTEGRATION_KEY&state=YOUR_CUSTOM_STATE&redirect_uri=YOUR_REDIRECT_URI

Properties:

Following are the properties of this connector and can be overridden by global context.

1. Host_Environment

Your DocuSign Host Environment. override property docusign_credentials.host_env_url

2. Integration_Key

Your DocuSign Integration key. override property docusign_credentials.integration_key

3. Secret_Key

Your DocuSign Secret key. override property docusign_credentials.secret_key

Following message properties can be inside the connector properties if provided.

  • global.get('docusign_credentials.host_env_url') => Host_Environment
  • global.get('docusign_credentials.integration_key') => Integration_Key
  • global.get('docusign_credentials.secret_key') => Secret_Key

The connector will store your access token and refresh token in following global properties

Access Token : docusign_credentials.access_token Refresh Token : docusign_credentials.access_token

2. About DocuSign Create Conect Configuration:

To create a custom connect configuration for the specified account.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Access_Token

Your authorization access token. override property msg.config.accessToken

5. Data_Property

List of signers to whom you want to resend the envelope. (check msg.model format below)

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.accessToken => Access_Token

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
envelopeId: "",
environment: "",
accessToken: ""
}

Sample msg.model

msg.data ={
"configurationType": "custom",
"urlToPublishTo": "YOUR-WEBHOOK-URL",
"allUsers": "true",
"name": "jsonSimTest",
"deliveryMode": "SIM",
"allowEnvelopePublish": "true",
"enableLog": "true",
"eventData": {
"version": "restv2.1"
},
"events": [
"demo event 1",
"demo event 2"
]
}

3. About DocuSign Create Envelope:

To create and send an envelope.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Access_Token

Your authorization access token. override property msg.config.accessToken

5. Data_Property

List of signers to whom you want to resend the envelope. (check msg.model format below)

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.accessToken => Access_Token

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
accessToken: ""
}

Sample msg.model

msg.data ={
"documents": [{
"documentBase64": "demo base 64 of document",
"documentId": "demo document id",
"fileExtension": "demo document file extension",
"name": 'demo document name'
}],
"emailBlurb" : "demo document email body/blurb",
"emailSubject": "demo document subject",
"recipients": {
"signers": [{
"email": "demo document signer email",
"name": "demo document signer name",
"recipientId": "demo document recipient id"
}],
},
"status": "sent"
}

4. About DocuSIgn Download Documents :

To download the documents uploaded in an envelope.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Access_Token

Your authorization access token. override property msg.config.accessToken

5. Document_Id

Your document Id for which you want to retrieve the document details. Override property msg.config.documentId

6. Envelope_Id

Your envelope ID associated with the document. Override property msg.config.envelopeId

7. Encoding_Type

Encoding type you want to return for the document. Override property msg.config.encodingType

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.accessToken => Access_Token
  • msg.config.documentId => Document_Id
  • msg.config.envelopeId => Envelope_Id
  • msg.config.encodingType => Encoding_Type

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
accessToken: "",
documentId: "",
envelopeId: "",
encodingType: ""
}

5. About DocuSign Get Documents List:

To get the list of documents uploaded in an envelope.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Access_Token

Your authorization access token. override property msg.config.accessToken

5. Envelope_Id

Your envelope ID GUID. Override property msg.config.envelopeId

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.accessToken => Access_Token
  • msg.config.envelopeId => Envelope_Id

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
accessToken: "",
envelopeId: ""
}

6. About DocuSign Get Envelope Status:

To retrieve the overall status for the specified envelope.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Envelope_Id

Your envelope's GUID for which you want to list the recipients. override property msg.config.envelopeId

5. Access_Token

Your authorization access token. override property msg.config.accessToken

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.envelopeId => Envelope_Id
  • msg.config.accessToken => Access_Token

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
envelopeId: "",
accessToken: ""
}

7. About DocuSign Get Recipient List:

To retrieve the status of all recipients in a single envelope and identifies the current recipient in the routing list.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Envelope_Id

Your envelope's GUID for which you want to list the recipients. override property msg.config.envelopeId

5. Access_Token

Your authorization access token. override property msg.config.accessToken

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.envelopeId => Envelope_Id
  • msg.config.accessToken => Access_Token

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
envelopeId: "",
accessToken: ""
}

8. About DocuSign Resend Envelope:

To resend an envelope to a recipient.

Properties:

Following are the properties of this connector and can be overridden by msg.config object.

1. Base_Url

Your DocuSign Base URL. override property msg.config.baseUrl

2. API_version

Your DocuSIgn API Version. override property msg.config.apiVersion

3. Account_Id

Your external account number (int) or account ID GUID. Override property msg.config.accountId

4. Envelope_Id

Your envelope's GUID for which you want to list the recipients. override property msg.config.envelopeId

5. Access_Token

Your authorization access token. override property msg.config.accessToken

6. Data_Property

List of signers to whom you want to resend the envelope. (check msg.model format below)

Following message properties can be inside the connector properties if provided.

  • msg.config.baseUrl => Base_Url
  • msg.config.apiVersion => API_version
  • msg.config.accountId => Account_Id
  • msg.config.envelopeId => Envelope_Id
  • msg.config.accessToken => Access_Token

Sample config

msg.config ={
baseUrl: "" ,
apiVersion: "" ,
accountId: "",
envelopeId: "",
environment: "",
accessToken: ""
}

Sample msg.model

msg.data ={
"signers": [
{
"recipientId": "77",
"name": "Demo",
"email": "bhanuja2001@gmail.com"
}
]
}